Developer Documentation

QuickTime 4 API Documentation

Inside Macintosh: Imaging with QuickDraw

Previous | Chapter Top | Chapter Contents | Next |

About Pictures

QuickDraw provides a simple set of routines for recording a collection of its drawing commands and then playing the collection back later. Such a collection of drawing commands (as well as its resulting image) is called a picture . A replayed collection of drawing commands results in the picture shown in Figure 7-1 .

Figure 1A picture of a party hat

When you use the OpenCPicture function (or the OpenPicture function) to begin defining a picture, QuickDraw collects your subsequent drawing commands in a data structure of type Picture . You can define a picture by using any of the drawing routines described in this book--with the exception of the CopyMask , CopyDeepMask , SeedFill , SeedCFill , CalcMask , and CalcCMask routines.

By using the DrawPicture procedure, you can draw onscreen the picture defined by the instructions stored in the Picture record. Your application typically does not directly manipulate the information in this record. Instead, using a handle to a Picture record, your application passes this information to QuickDraw routines and Picture Utilities routines.

The OpenPicture function, which is similar to the OpenCPicture function, was created for earlier versions of system software. Because of the support for higher resolutions provided by the OpenCPicture function, you should use OpenCPicture instead of OpenPicture to create a picture.

Picture Records

Opcodes: Drawing Commands and Picture Comments

Color Pictures in Basic Graphics Ports

'PICT' Files, 'PICT' Resources, and the 'PICT' Scrap Format

The Picture Utilities


© 1997 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents | Next